=====================================================================
  BG LAUNCHER 2.6.9 · GUÍA DE INSTALACIÓN
  BarGames · MU Online Tools · https://bargameservers.com
=====================================================================

Qué hay en este paquete
  Launcher.exe ............ el launcher que usan tus jugadores
  Publicador.exe .......... tu herramienta: configura, publica y actualiza
  webengine\bg-launcher.php  conector para WebEngine (el Publicador lo
                              instala solo; está aquí por si hace falta)

Qué necesitas
  - Tu cliente de Mu (la carpeta con Main.exe).
  - Un hosting con cPanel y una cuenta FTP (cPanel > Cuentas FTP).
  - (Opcional) Tu web WebEngine o WordPress, para noticias y jugadores online.
  - La IP pública de tu VPS (para mostrar EN LÍNEA / OFFLINE).


---------------------------------------------------------------------
 INSTALACIÓN EN 5 PASOS (pestaña "★ Inicio rápido" del Publicador)
---------------------------------------------------------------------
 1. TU CLIENTE    Elige la carpeta del cliente. Debe salir "✔ Cliente encontrado".

 2. TU HOSTING    Dominio, servidor FTP, usuario y contraseña, y un nombre
                  de carpeta sin espacios (ej.: s6). Pulsa "Conectar y
                  preparar la carpeta": el Publicador crea la carpeta en el
                  hosting y averigua la dirección pública él solo.

 3. TU WEB        Dirección de tu web y "Detectar y conectar mi web".
                  WebEngine (cualquier plantilla): encuentra el conector o
                  lo instala por FTP. La plantilla BG Legend ya lo trae.
                  WordPress: tus entradas salen como noticias.
                  ¡OJO! Si tu cuenta FTP no llega a la carpeta de la web,
                  el Publicador no puede subir el conector: te avisa y te
                  deja bg-launcher.php en el Escritorio. Súbelo a mano con
                  cPanel > Administrador de archivos a la carpeta "api" de
                  tu WebEngine (y a templates/bglegend si usas BG Legend),
                  y vuelve a pulsar el botón: debe salir en verde.

 4. TU SERVIDOR   IP pública del VPS y puerto del ConnectServer (44405).

 5. PUBLICAR      Nombre del servidor y "Publicar todo".
                  Sube la lista de archivos, el diseño y el launcher, y deja
                  Launcher.exe dentro de tu cliente.

Después: comprime tu cliente completo (ya con Launcher.exe y launcher.ini)
y súbelo a Mega/MediaFire. Tus jugadores lo descargan y abren Launcher.exe.


---------------------------------------------------------------------
 DÍA A DÍA
---------------------------------------------------------------------
  - ¿Cambiaste archivos del cliente? Publicador > "Publicar todo".
    Los jugadores descargan SOLO lo que cambió al abrir el launcher.
  - Diseño (colores, fondo, logo, redes, botones): pestaña "3. Diseño" >
    "Guardar y publicar diseño". Lo ven todos al abrir el launcher.
  - Launcher nuevo de BarGames: pon el Launcher.exe nuevo junto al
    Publicador y pulsa "Publicar launcher nuevo": se actualiza solo en
    todos los jugadores.


---------------------------------------------------------------------
 QUÉ VEN TUS JUGADORES
---------------------------------------------------------------------
  - Noticias de tu web (la primera, destacada con imagen), estado del
    servidor y una barra lateral con Opciones, Reparar, tus botones y redes.
  - Eventos con cuenta atrás, sacados de tu WebEngine (api/events.php).
  - Actualización automática y botón "Reparar".
  - Opciones del juego: usuario predeterminado, resolución, ventana,
    idioma, sonido, gráficos y animaciones del launcher.
  - Si falta Visual C++, un aviso para instalarlo (instalador oficial de
    Microsoft, comprobado).
  - Ofrece crear un acceso directo en el escritorio.
  - Un solo launcher abierto: si lo abren otra vez, sale el que ya estaba.
  - Al pulsar JUGAR el launcher se cierra (o se minimiza con "Mis cuentas").
    Nunca se queda escondido junto a la hora.
  - Se ve nítido en pantallas con zoom (125 %, 150 %...).


---------------------------------------------------------------------
 PLAN GRATIS Y PRO
---------------------------------------------------------------------
  Gratis: todo lo anterior, con la marca "Powered by BarGames".
  PRO: viene en el PLAN PRO de BarGames (https://bargameservers.com/planes/),
  junto con las Herramientas Pro y las guías de instalación. Pruébalo 7 días gratis
  desde tu Centro de gestión. Tu licencia del launcher sale en tu Centro (Mi plan
  Pro), para tu dominio y 2 subdominios. Incluye:
    - Sin la marca.
    - Jugadores conectados en el launcher.
    - "Mis cuentas": entrar con un clic y varias cuentas a la vez.
    - Avisos de nivel y reset.
    - Vídeo de fondo y ambientes (nieve, lluvia, luciérnagas).
    - Avisos en directo y modo mantenimiento (pestaña "4. En directo").
    - Campana en los eventos: aviso de Windows 5 minutos antes.
  Pega la licencia en "3. Diseño" > Licencia PRO y pulsa "🔑 Comprobar
  licencia": te dice si está activa o por qué no.

  ACTUALIZACIONES: cuando BarGames saca una versión nueva, tu Publicador te
  avisa al abrirse. Pulsa "Actualizar": se actualiza solo y la sube a tu
  hosting; tus jugadores la reciben al abrir el launcher. Si algo falla:
  "1. Proyecto" > "Versión anterior".


---------------------------------------------------------------------
 PROBLEMAS FRECUENTES
---------------------------------------------------------------------
  - "Usuario o contraseña del FTP incorrectos": revísalos en cPanel >
    Cuentas FTP (el usuario suele ser usuario@tudominio.com).
  - "No encuentro la carpeta en la web": mira en cPanel > Cuentas FTP el
    "Directorio" de tu cuenta. Configura a mano en la pestaña
    "1. Proyecto" la "Carpeta en el FTP" y la "Dirección pública", y pulsa
    "Probar conexión FTP". Ejemplo: si la cuenta apunta a
    public_html/launcher, la carpeta en el FTP es "s6" y la dirección
    pública https://tudominio.com/launcher/s6/
  - Noticias vacías u online sin datos: repite el paso 3.
  - Windows bloquea el Publicador o el launcher ("Control inteligente de
    aplicaciones" de Windows 11 o SmartScreen): son programas nuevos sin
    firma digital. En SmartScreen: "Más información" > "Ejecutar de todas
    formas". Con el Control inteligente activado, usa otro PC para el
    Publicador.

---------------------------------------------------------------------
 NOVEDADES 2.6 · BG GUARD DENTRO DEL LAUNCHER
---------------------------------------------------------------------
  BG GUARD es el antihack con servidor de protección de BarGames. Se
  contrata aparte (web y panel en bgguard.bargameservers.com) y va DENTRO
  del launcher: el jugador no instala nada más.

  LICENCIA
   - Con BG Guard te damos una licencia BGG-XXXX-XXXX-XXXX-XXXX. Pégala
     en Publicador > 3. Diseño > Licencia: incluye el launcher completo
     (todas las funciones PRO del launcher). No incluye las Herramientas
     Pro de la web, que son del plan PRO.
   - Si ya tienes el plan PRO (licencia BGL-...), BG Guard se activa con
     esa misma licencia: no hace falta otra.

  ACTIVARLO (Publicador > 3. Diseño)
   1. Marca "BG Guard: antihack con servidor de protección".
   2. "Versión en BG Guard": la que guardaste en tu panel (ej. 1.04).
   3. "Archivos con huella": los mismos que en tu panel (ej. Main.exe,
      Data/Player/player.bmd), uno por línea.
   4. "Guardar y publicar diseño".

  QUÉ HACE AL PULSAR JUGAR: busca programas de trampa (los de serie, la
  lista global de BarGames y los tuyos), comprueba los archivos, pide una
  sesión cifrada a BG Guard (licencia, versión, huella de los archivos, PC
  baneado), espera unos segundos si tienes el "Modo puerta" y manda
  latidos mientras juega. Si lo expulsas desde tu panel o se pierde la
  sesión, el juego se cierra.

  MODO PUERTA (recomendado): instala el agente en el VPS del GameServer
  con configurar-agente.bat (paquete BGGuard-Agente). Así, abrir el
  Main.exe sin el launcher no conecta.

  RETIRADO EN 2.6
   - La protección básica antigua de BG Guard (detecciones y baneos en el
     Centro de gestión). Ahora todo va en el panel de BG Guard.
   - La opción "Candado del main" del Publicador. Si tu files ya lo tenía
     activado, no tienes que hacer nada: el launcher sigue siendo
     compatible y el juego abre igual (2.6.1).
   - La "Puerta del Main.exe". Si la tenías, el launcher devuelve solo el
     Main.exe a su sitio.
  Se mantiene "Ocultar Main.exe en la carpeta del juego".

  PANTALLA DE CARGA (2.6.2): al pulsar JUGAR el launcher se minimiza y solo
  queda la pantalla de BG Guard en el centro. La barra llega siempre al
  100 %, la imagen se pone en VERDE y entonces se abre el juego (en ROJO si
  algo falla, y después vuelve el launcher con el motivo).

  AL CERRAR EL JUEGO (2.6.3): la sesión de BG Guard termina al momento, y el
  agente del Modo puerta corta cualquier conexión al GameServer de una IP sin
  sesión. Ya no sirve cerrar el juego y abrir el Main.exe a mano enseguida.

  CON EL JUEGO ABIERTO (2.6.4): mientras el launcher está abierto, cualquier
  Main.exe que no haya abierto él (aunque sea una copia con otro nombre) se
  cierra al momento y vuelve el launcher con el aviso «el juego solo se abre
  desde el launcher». Para abrir otra ventana del juego: JUGAR otra vez.
  (2.6.5) El Main.exe de OTRO servidor de MU que tenga abierto el jugador no
  se toca: solo el de esta carpeta o una copia suya.
  Arreglado también: el juego ya no se cierra a los 2 minutos con «Se perdió
  la conexión con BG Guard» (era el servidor de BG Guard: Actualizar-7).

  AVISOS Y VENTANAS (2.6.6): los avisos que el admin escribe en su consola de
  BG Guard salen encima del juego unos segundos. Y si el admin limita las
  ventanas del juego por PC, el launcher no deja abrir más.

  CONEXIÓN MÁS FUERTE (2.6.7): si el servidor de BG Guard se reinicia o internet
  se corta unos segundos, el launcher se reconecta solo y la partida sigue.

  IMPORTANTE (2.6.8): la carpeta del Publicador NO va dentro del cliente del
  juego. Si está dentro, el Publicador ya no la publica (antes los jugadores
  veían «huellas-cliente.txt llegó dañado»).

  HUELLAS AL PUBLICAR (2.6.8): marca «Actualizar las huellas en BG Guard al
  publicar» y escribe la contraseña de tu panel de BG Guard (se guarda cifrada
  en tu PC). Al publicar por FTP, el Publicador guarda la versión y las huellas
  en tu panel: ya no hace falta hacerlo a mano en «Mi cliente».

  ANTIHACK DENTRO DEL JUEGO (2.6.9): mientras se juega, BG Guard vigila el
  juego: DLLs inyectadas, hacks conocidos en su memoria y programas de trampa
  que lo manejan desde fuera. En tu panel de BG Guard (Modo puerta > «DLL
  inyectada en el juego») eliges si solo avisa o expulsa, y tras cuántas
  detecciones (recomendado 3). Empieza solo observando unos días.

  PERMISO DE ADMINISTRADOR (2.6.9): el launcher pide permiso de administrador
  al abrirse. Es necesario para vigilar el juego (el Main.exe de muchos files,
  como Louis, va como administrador). Avisa a tus jugadores para que pulsen Sí.

  Sin BG Guard marcado, el launcher funciona igual que antes (sin
  protección de BG Guard).

---------------------------------------------------------------------
 NOVEDADES 2.5.2
---------------------------------------------------------------------
  Arreglado: el paso 2 del Inicio rápido decía «El FTP funciona, pero no
  encuentro la carpeta subida» cuando la cuenta FTP apunta directamente
  a la carpeta del launcher (ej.: public_html/launcher/s6). Ahora la
  detecta sola.

---------------------------------------------------------------------
 NOVEDADES 2.5.1
---------------------------------------------------------------------
  Arreglado: el Publicador podía mostrar un error («El valor de '700'
  no es válido para 'Value'») al publicar. Ya no pasa.

---------------------------------------------------------------------
 NOVEDADES 2.5.0 · MARCA NUEVA
---------------------------------------------------------------------
  Nueva imagen de BarGames: icono <BG> en el launcher y el Publicador,
  «Powered by BarGames» en el plan gratis y colores nuevos por defecto
  (ámbar #f2a33a para JUGAR y cian #34d1e0 para la barra). Tu diseño
  guardado no cambia: si ya elegiste tus colores, se respetan.

---------------------------------------------------------------------
 NOVEDADES 2.4.7
---------------------------------------------------------------------
  Al pulsar «Terminar mantenimiento» el aviso de mantenimiento desaparece
  del launcher, de la web BG PRO y de la campana, y sale en verde
  «Servidor abierto: ya puedes jugar» (antes podía quedarse el aviso).

---------------------------------------------------------------------
 NOVEDADES 2.4.6 · AVISOS EN DISCORD Y WHATSAPP (PRO)
---------------------------------------------------------------------
  Publicador > 4. En directo > «Avisar también en Discord y WhatsApp».

  DISCORD (automático): en tu Discord, Editar canal > Integraciones >
  Webhooks > Nuevo webhook > Copiar URL del webhook. Pégala en el
  Publicador y pulsa «Probar Discord». Desde entonces cada aviso, el
  mantenimiento y su final salen solos en ese canal.

  WHATSAPP: WhatsApp no deja que un programa escriba solo en un grupo
  (los bots que lo hacen acaban con el número baneado). Al enviar un
  aviso se abre WhatsApp con el mensaje ya escrito: eliges el grupo y
  pulsas enviar. También está el botón «Compartir en WhatsApp».

  El webhook se guarda solo en tu PC (proyecto.json), no se sube.

---------------------------------------------------------------------
 NOVEDADES 2.4.5
---------------------------------------------------------------------
  Campana de avisos (PRO): ahora se lee el texto completo de cada aviso y
  del mantenimiento, con saltos de línea (antes se cortaba con «…»).

---------------------------------------------------------------------
 NOVEDADES 2.3.2
---------------------------------------------------------------------
  - CAMPANA DE AVISOS (PRO): arriba, junto al estado del servidor. Sale con
    un número (1, 2, 3...) según los avisos activos: avisos en directo,
    mantenimiento y parche pre-descargado. Al pulsarla se ven todos.
  - Los avisos en directo y el mantenimiento salen ahora también como aviso
    de Windows (junto a la hora), igual que el reset de un personaje.
  - "4. En directo": hasta 5 avisos a la vez. "Quitar todos" los borra.
  - Paso 3 del Inicio rápido: si no puede subir el conector nuevo, lo dice
    claro y te deja el archivo en el Escritorio para subirlo a mano.

---------------------------------------------------------------------
 NOVEDADES 2.3.1
---------------------------------------------------------------------
  - Pestañas del panel derecho rediseñadas: una sola barra, todas del
    mismo ancho y con la misma letra.
  - Si tu web tiene el conector antiguo, el panel lo dice claramente.
    Actualízalo con el paso 3 del Inicio rápido o subiendo a mano
    webengine\bg-launcher.php a la carpeta api de tu WebEngine.

---------------------------------------------------------------------
 NOVEDADES 2.3 (PLAN PRO)
---------------------------------------------------------------------
  - Panel del SERVIDOR: jugadores ahora, pico de hoy, gráfico de 24 h,
    dueño del Castle Siege y top 3. Necesita el conector 3 en tu WebEngine:
    el paso 3 del Inicio rápido lo actualiza solo por FTP.
  - PERSONAJE: el jugador sigue hasta 3 personajes por su nombre (sin
    contraseña) y recibe avisos de nivel y reset. Funciona con cualquier files.
  - VOTAR: pon tus webs de votación en "3. Diseño" > Votar
    (Nombre | enlace | horas). El launcher recuerda cuándo puede volver a
    votar cada jugador y le avisa.
  - NOVEDADES DEL PARCHE: escríbelas en "2. Publicar" antes de publicar
    (ej. "NUEVO: Seals de 30 días"). Tus jugadores las ven una vez, al
    actualizar.
  - PRE-DESCARGA: marca "Pre-descarga" en "2. Publicar" y elige día y hora.
    Los jugadores PRO descargan el parche ya y se activa solo a esa hora
    (la del hosting). Actualiza tu servidor a esa misma hora.
  - PROTECCIÓN DEL CLIENTE: en "3. Diseño" > Archivos protegidos pon, por
    ejemplo, Main.exe y Main.dll. Antes de JUGAR se comprueban y, si alguien
    los modificó, se reparan solos. Tienen que estar en "Siempre en el
    hosting".
  - ESTADÍSTICAS: en tu Centro de gestión (Mi plan Pro) ves cuántos jugadores
    tienen la última versión y los errores al actualizar.
  - DISEÑO: personaje en primer plano (PNG que se mueve con el ratón) y
    animación de entrada.

---------------------------------------------------------------------
 NOVEDADES 2.2
---------------------------------------------------------------------
  - Diseño nuevo: barra lateral de iconos, noticia destacada con imagen,
    panel de eventos, barra fina con velocidad y tiempo restante, el botón
    JUGAR se llena de energía al descargar y el borde de la ventana cambia
    de color según el estado (listo, descargando, error, mantenimiento).
  - Barra lateral: Opciones y Reparar siempre; tus botones y redes salen
    solo si les pones enlace. Orden: "3. Diseño" > "Orden de la barra lateral".
    Icono de un botón (opcional): Texto | enlace | web, user, shop, rank,
    download, info o link.
  - EVENTOS: el launcher enseña los horarios de api/events.php de tu
    WebEngine (el paso 3 del Inicio rápido lo configura solo).
    ¡IMPORTANTE! Pon en ese archivo los horarios REALES de tu servidor y su
    zona horaria (date_default_timezone_set). WebEngine trae unos horarios
    de ejemplo: si no los cambias, el launcher enseñará horas equivocadas.
    Con el plan Pro, la herramienta "Eventos automáticos" de bargameservers.com
    lee tus files y te da el events.php ya hecho: súbelo a api/ reemplazando
    el que hay.
  - Usuario predeterminado (gratis y PRO): el jugador lo pone en Opciones y
    le sale ya escrito en el login del juego. Solo el usuario, nunca la
    contraseña. Se guarda en el registro del juego (valor "ID"); si tus
    files usan otro, cámbialo en Opciones avanzadas (userRegValue).
  - PRO · Vídeo de fondo: "3. Diseño" > "Elegir vídeo…" (MP4, MOV o WMV).
    Se usan los primeros 10 segundos en bucle, sin sonido (unos 10 MB).
    Los jugadores lo descargan una sola vez y pueden apagarlo en Opciones.
  - PRO · "4. En directo": avisos que ven los jugadores al momento y modo
    mantenimiento (JUGAR bloqueado con cuenta atrás). Tú puedes entrar
    igualmente con Ctrl + clic en JUGAR.

---------------------------------------------------------------------
 NOVEDADES 2.1 / 2.1.1
---------------------------------------------------------------------
  - La IP de tu VPS ya no se ve en config.json (ni en el hosting ni en la
    carpeta .launcher de los jugadores): el Publicador la guarda cifrada.
  - La copia que guarda el launcher (.launcher\config.dat) va cifrada y la
    carpeta .launcher queda oculta.
  - 2.1.1: textos más nítidos y con más contraste (letra al estilo de Windows,
    un poco más grande, colores más claros y una sombra suave).
  - Para aplicarlo: abre el Publicador 2.1.1 y pulsa "Guardar y publicar
    diseño" y después "Publicar launcher nuevo" (con el Launcher.exe 2.1.1
    junto al Publicador). Tus jugadores se actualizan solos.
  - Ojo: el juego se conecta a tu IP, así que un jugador avanzado siempre
    podría verla (por ejemplo con netstat). Esto evita que se lea a simple
    vista; protege tu VPS con el firewall abriendo solo los puertos del juego.

Soporte: WhatsApp desde el Centro de gestión de bargameservers.com
